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Unisys believes that the software described in this manual is 
accurate, and much care has been taken in its preparation^ 

The customer's attention is drawn to the provisions of the Trade 
Practices Act 1974 (as amended) ('the Act') which imply conditions 
and warranties into certain contracts for the supply of goods and 
services. Where such conditions and warranties are Implied 
Unisys liability shall be limited (subject to the provision of 
Section 68A of the Act) to the replacement or repair of the goods 
or the supply of equivalent goods. 

The customer should exercise care to assure that use of this manual 
and the software will be in full compliance with the laws, rules and 
regulations of the jurisdiction in which it is used. 

The information contained herein is subject to change. Revisions 
may be issued from time to time to advise of changes and/or 
additions. 

Correspondence regarding this publication should be forwarded using 
the Remarks Form at the back of the manual , or may be addressed 
directly to Unisys Corporation, Corporate Product Information, 
4100 Plymouth Road, Building 4, Plymouth, Michigan 48170, USA. 
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About This Guide 

This Quick Reference Guide is for experienced operators 
and administrators who are already familiar with the 
functions and features of BTOS and BTOS workstations, 
and with the material presented in the BTOS Standard 
Software Operations Guide. 

Therefore, it is assumed that you know how to perform 
basic tasks, such as turning your workstation on and off, 
and signing on and off, etc. 

This guide is divided into two sections: 

a Section 1, Commands, consists of an alphabetical listing 
of the BTOS commands that you enter by either typing 
the command and pressing GO, or typing the command, 
pressing RETURN, and filling in the command form. 

a Section 2, Tables, is a compilation of tables extracted 
from the BTOS Standard Software Operations Guide 
and consolidated for easy access. 

This guide also includes a table of contents and a 
comprehensive index to help you quickly find the 
information you need. 
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Commands 
Introduction 

This section contains an alphabetical listing of the BTOS 
commands you enter by either typing the command and 
pressing 60, or typing the command, pressing RETURN, 
and filling in the command form. 

Each command listing includes the following: 

□ a figure illustrating the command form 

D a description of the entries you must make in the 
command form's mandatory fields 

□ a description of the entries you can make in the 
command form's optional fields 
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JT UJT V 




1 

X 


APPRMD Cnmmand Form 

ixL X X^i^ Xy V^vlllllllClllVl i V/l iti 


2 


BACKUP VOMIME Command Form 




HOOTSTRAP Command Form 

XJVyW 1 O X XVXiiX V^wllllllclXllX X %Jl III 


4 


CHANOF VOLIIMR NAME Command Form 

V_y X X xA i N VJ Xli V iwlxU INxViVXXlJ V/UIllXll£lllvX X V/IXIl 


f; 


CIJISTKR STATUS Command Form 

v^xjuoxx_jxv ox r\ x u o v^vjxitxiicxxivx x \Jt xti 


\/ 


f!OMMANin FII.R EDITOR Cnmmflnri Form 


7 


nOPY rinmmanri Form 


tt 

O 


CREATE CONFTCTIRATTON FILE Command Form 


q 


CREATE DIRECTORY Command Form 

V^XVXj.^ X X^XXVXJV^ X VyXV X v^VXIIXIIClXlvt X \Jl Xll 


1 0 


CREATE FTI.F Command Form 

V/XVX^i&. X XJ X XX^XJJ V^LIXllllldXlvl X V/X Xll 


1 1 


CREATE PARTITION Command Form 

x^xvxjxa X xzi X /Axv XXX xvyxi v^wxiixiicixivi x i/x xii 


12 

X M 


DERI If} FILE Command Form 

X^XJXJl^VJ X XX^XJ VwXllXtlClXlU X vXXII 


X tj 


DELETE Command Form 

l^A^JLiXJ X X-i V^Vyi 1 11 1 IdX tU X Wl XLl 


14 


DISABLE CLUSTER Command Form 


IS 

X Cl 


DUMP CnmmanH Form 

1-/ VJ iVi X V^l^XIIXIIdXlU X V/X Xll 


16 


EDIT Command Form 

X^l-^X X V^\/XllXIICIiXI\X X vrXXll 


17 


FILF!S Command Form 

X XXJI-ilk7 V^V/XIIXHcl'XIvl X V/X Xll 


18 


FLOPPY COPY Command Form 


19 


FORMAT Command Form 

X V/XvlfXXk, X V>V/1 llll t<li 1 vX X V/X lit 


20 


INSTALL PROTECTED MODE Command Form 

X k/ X aVXJXJ X Xl>V/ X XJV^ X X-jX^ IwAXJ V^VJl 1 11 1 1 CXX IVX X V/X Xll 


21 


INSTALL SPOOLER Command Form 

Xi^kkJ X ^&XJLi KJK V/V/X^XJJXV V^/V/XllXllCliX IVX X V/XXtl 


22 


INSTALL TELEPHONE SERVER Command Form 

X X V KJ A jr\ I X XjfX^X^X X X V^l 1 JLJ Kjl^».% T 1.4 Xv VxV/Xft 11 IICXX IVI X V/X 111 


23 


I VOLUME Command Form 

X V \J U KJ ITl Xj V^V/ll iXIKXX I VX X V/l Xll 


24 


LCOPY Command Form 

XjV/V^I X V.^V/1 1 11 1 IdX IVX 1 v/l 111 


25 


LIST Command Form 

1-iXW/ X V_>V/lllllidXIVX X V/tlll 


26 


KOfrlM domrnjinfl Fnrrn 

xjvyvjixi^ v>v/xiixiidxivx x v/xxn 


27 


MAINTAIN FILE Command Form 

iVXxXXl^ X xVXXl X XXJX^ Vi/V/XIIXIldXlvl X V/X Xll 


28 


MAKE TRANSLATION FILE Command Form 

ITX XAl \ XiJ X iVXk ilk/ XJxV X X v/ i " 1 1 l^XJ V^V/lllJIlldX IVX X V/X X 1 1 


29 


MEROE Command Form 

ivXXJXVVJXJ V^V/lllXlldXlVX X v/l ill 


30 


NE^W COMMAND Command Form 

i ^ M-d f T V/ ITl iTXxX i 1 !»/ yj 1 1 11 1 IdX Ivl X V/X 1 11 


31 


PATH Command Form 

X xV X XX V^V/llll lldl 1 VI X v/l Xll 


32 


PLAYBACK Command Form 

X kJtXx. X XJxVNw'XV V^V/1 1 11 1 Idl tVX X V/X 111 


33 


PLOG Command Form 

X XJV/Vji X/VllllllClillVX X v/l 11* 


34 


PRINT Command Form 

1 XlrXi^ X wl 1 11 Kldil IVX X V/X lit 


35 


RECORD Command Form 

1 V X-i V> X V 1— ' WlllllldllVl 1 v/l 111 


36 


REMOVE COMMAND Command Form 

1 V i-ilTX V_/ r X^ W Vy ITX ITX X*. i 1 JL-' V/ V/l 111 1 Xdl IVX X V/l H ^ 


37 


remove: DIRECTORY Command Form 

I b X^iTX V_/ T A. J jL^ M IV 1-iV^ X V/X V X V/V/1 1 IX It CXI 1 VI X VFl All 


38 


RENAME Command Form 

1 V X^I^ ^X.l*X X^ V/Vf X 1 11 lldl 1 VI X Willi 


39 


REPLAY Command Form 

IVXJX MJUx. X V/V/XI 11 1 IdX IVX X v/l lit 


40 


RESTORE Command Form 


41 


RUN Command Form 


42 


RUN FILE Command Form 


43 


SCREEN SETUP Command Form 


44 


SELECTIVE BACKUP Command Form 


45 


SET DIRECTORY PROTECTION Command Form 



Commands 



1-3 



46 SET FILE PREFIX Command Form 

47 SET PROTECTION Command Form 

48 SET TIME Command Form 

49 SOFTWARE INSTALLATION Command Form 

50 SORT Command Form 

51 SUBMIT Command Form 

52 TYPE Command Form 

53 USER FILE EDITOR Command Form 

54 VIDEO Command Form 

55 VOLUME STATUS Command Form 

56 WRITE HARDWARE ID Command Form 

57 XESOFTWARE INSTALLATION Command Form 
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APPEND Command 

Figure 1 APPEND Command Form 



\ni» list nm] [ 

Fil* to 

COanrini Mch?) 



Mandatory fields: 

File list from Enter the name(s) of the file(s) 

you want to append. You can use 
the wild card character in this field. 



File to Enter the name of the file in 

which you want the file or list of 
files merged. If this destination 
file does not exist, the system 
creates it. 



Optional field: 

[Confirm each?] If you accept the default (no), the 

system does not prompt you for 
confirmation of each file you 
want to append. 

To receive a prompt for 
confirmation of each file, you 
enter y in this field. 
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BACKUP VOLUME Command 

Figure 2 BACKUP VOLUME Command Form 



Backup Volume 

} Volume or device name { 

[Volume or device password] 

[incremental from (e.g., Mon. 3 Dec 1984 8:00 pm)] 

[Suppress backup?] 

[Suppress verification?] 

[Archive file] 

[Delete existing archive file?] 
[Log file] 

[Display structures?] 
[Verify write?] 



Mandatory field: 
Volume or device 



name 



Enter the name of the volume or 
device you want to backup. 



Optional fields: 

[Volume or device 
password] 



[Incremental from 
(e.g., Mon 3 Dec 
1984 8:00 pm)] 



The default indicates that no 
password is assigned to the 
volume or device you want to 
backup. 

If the volume or device you want 
to backup has a password, enter 
the password in this field. 

The default directs the system to 
backup all files on the volume or 
device. 

To backup only those files 
modified on or after a specific 
date, enter the beginning date. 
The time is optional. If you do not 
enter a time, the system backs up 
all files modified and/or created 
since 12:00 AM (midnight) of the 
specified day. 
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[Suppress backup?] 



[Suppress 
verification?! 



[Archive file] 



[Delete existing 
archive file?) 



Use the following guidelines when 
making incremental backups: 

D Perform a full backup 

whenever you increase the size 
of a directory. 

o Files that you delete during the 
week are not reflected in an 
incremental backup. 

The default is no; the system 
backs up the files you specified. 

To verify the integrity of the 
volume control structures without 
performing a backup, enter y. 

The default is no; the system 
verifies the integrity of the 
volume control structures. 

To backup the files only, without 
verifying the integrity of the 
volume control structures, enter y. 

The default directs the system to 
create {Archive]<Sys>.nn as the 
default archive file name (nn 
represents a number the system 
supplies). 

To assign a name other than 
Archive to the file which the 
system creates, enter the name in 
this field. 

The default is no. If you accept 
the default and the archive file 
already exists, the system 
displays the following when you 
complete the command form and 
press GO: 

File already exists. Delete? 
(Press GO to confirm, CANCEL 
to deny, or FINISH to return to 

the Executive.) 

To automatically overwrite the 
existing archive file, enter y. 
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[Log file] The default directs the system to 

display the log on the screen only. 
To write a report of the BACKUP 
VOLUME operation to a file, enter 
the name of the file you want it 
written in. If the log file already 
exists, the system automatically 
appends the log to it. If it does 
not exist, the system creates it. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 

[Display structures?] The default is no; the system does 

not display an analysis of the 
volume control structures. 

To display a detailed analysis of 
the volume control structures, 
enter y. 

[Verify write?] The default is no; the system does 

not perform a physical read after 
each write to insure that the 
file(s) you are backing up are the 
same as the previously backed up 
file(s). 

Note: It is probably not necessary to fill in 
the [Verify write?] field if you have verified 
the hard disk or diskette for bad spots using 
the IVARCHIVE command. 

To verify each read and write 
operation for the file(s) that you 
are backing up, enter y. 
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BOOTSTRAP Command 

Figure 3 BOOTSTRAP Command form 



Bootstrap 



jFile to bootstrap froi | 
[sys voiuM or vsnm] 



Mandatory field: 

File to bootstrap 
from 



Enter a parameter (for example, 
[Sys]<Sys>SysImage.sys 



Optional field: 

[Sys volume or 
wsNNN] 



Specify a local volume or the 
master volume as the system 
volume. The default is your 
workstation volume and file 
name. 
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CHANGE VOLUME NAME Command 

Figure 4 CHANGE VOLUME NAME Command Form 



Owngs VoluM Nhb 

(Davloe pMswnrd] 
(Old voluHB passwnl] 

(Nw vUiM pnswM] 



Mandatory fields: 

Device name Enter the name of the device that 

contains the volume whose name 
you want to change. 

New volume name Enter the new name (a maximum 

of 12 characters) to assign to this 
volume. If you want to add, 
change, or delete a password only 
for the volume, you enter the 
existing name and then enter 
parameters in the appropriate 
optional fields. 



Optional fields: 
[Device password] 



[Old volume 
password] 



The default indicates to the 
system that no password is 
assigned to the device containing 
the volume you want to change. 

If a password is assigned to the 
device containing the volume you 
want to change, enter the 
password in this field. 

The default indicates to the 
system that no password is 
assigned to the volume you want 
to change. 

If a password is assigned to the 
volume you want to change, enter 
the password in this field. 
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[New volume 
password] 



The default directs the system to 
leave the new volume 



unprotected; no pas3word is 
necessary to access it. 

To change or assign a password to 
the volume named in the New 
volume name field, enter the 
word or characters (a maximum 
of 12) you want to use for the 
password. You cannot change or 
assign a password to the volume 
currently in use. 
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CLUSTER STATUS Command 

Figure 5 CLUSTER STATUS Command Form 



C luster Status 

I [Line iMcer (OBfauit ■ o)] | ! ^ ^ ' , 
[On tim dl^ilay?] 



Optional fields: 

[Line number The default is 0 for a standard 

(default = 0)] channel. 

To request status information for 
a communications line other than 
the standard channel, enter the 
line number. 

[One time display?] The default is no; the status 

display remains on the screen and 
is updated every second. 

To request a one-time status 
display, enter y; the status 
display remains on the screen, but 
is not updated. 
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COMMAND FILE EDITOR Command 

Figure 6 COMMAND FILE EDITOR Gomthand Form 



Co— iTd nia Editor 
I [onwana f lleTl f" 



Mandatory field: 

[Command file] Enter the command file you want 

to adcess. 
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COPY Command 

Figure 7 COPY Command Form 



copy 



[Fllefi05_J| 
File to 

[OvenirltB ok?] 
[Oanrin eacn?] 



Mandatory fields: 
File from 

File to 



Optional fields: 
[Overwrite ok?] 



Enter the name of the file you 
want to copy. 

Enter the name of the file to 
receive the copy of the file you 
named in the File from field. If 
the file does not exist, the system 
creates it. 

If you accept the default and a 
file named in the File to field 
already exists, the system 
displays the following 
confirmation message when you 
complete the command form and 
press GO: 



File (File name) already exists. 
Overwrite? (Press GO to 
confirm, CANCEL to deny, or 
FINISH to stop command.) 

If you enter n, the system does 
not perform an overwrite 
operation. 

To overwrite an existing File to 
field file, enter y. The system 
deletes the contents of the 
existing file and continues the 
copy operation. 
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[Connrm each?] 



The default is no; the system does 
not prompt you to confirm each 
copy operation. 

To receive prompts to confirm 
each copy operation, enter y. 



Commands 



1-15 



CREATE CONFIGURATION FILE Command 

Figure 8 CREATE CONFIGURATION FILE Command Form 



Create Configuration File 
I Configuration file nane 



Device type (oom^ parallel ipt, or serial ptr) 



Mandatory fields: 

Configuration 
file name 



Device type (comm, 
parallel Ipt, or 
serial ptr) 



Enter a new configuration file 
name to create a new file, or enter 
the name of an existing 
configuration file you want to 
modify. 

Specify the type of device you 
want to configure: 

a Enter the letter c for a 
communications device. 



o Enter the letter p for a parallel 
printer (direct or spooled). 

□ Enter the letter s for a serial 
printer (direct or spooled). 
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CREATE DIRECTORY Command 

Figure 9 CREATE DIRECTORY Comitiand Form 



Create Directory 



New Directory hamd(s) 



[Protection level (default - IS)] 
[Maximum number of files (default 
[Password for new directory] 
[Volume password] 



75)1 



Mandatory field: 

New directory 
name(s) 



Enter a name for the new 
directory you want to create^ 



Optional fields: 

[Protection level The default assigns an 

(default =15)1 unprotected (15) protection level 

to all files in the di rectory (ies). 

To assign a modify protected (5) 
of an access protected (0) 
protection level to the files in a 
directory, enter the appropriate 
number. 

[Maximum number of The default sets the maximum 
files (default = 75)] number of files for each directory 

at 75. to set the mstxirhum file 
limits for the directory to a larger 
or smaller number, enter the 
niimbefi 

[Password for The default leaves the new 

new directory] directory(ies) unprotected; no 

password is necessary to access it. 

To assign a password to the 
directory, enter the word or 
characters (a maximum of 12) yoii 
want to use for the passwords 
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[Volume password] 



The default indicates that a 
password is not assigned to the 
volume. 

If the volume has an assigned 
password, you must enter the 
password to gain access to the 
volume. 
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CREATE FILE Command 

Figure 10 CREATE FILE Command Form 

( areata File 

{VoluB or Olnctary pesswrd] 
inu PMSMTd) 

(File prateetlon level (dtfeult > IS)] 
(sue In Mctsr* (Oaftult • 0)] 
(OMtwlte OK?] 



Mandatory field: 

File name Enter the name you want to 

assign to the new file. 



Optional fields: 

[Volume or directory 
password] 



[File password] 



[File protection 
level (default - 15)] 



The default indicates to the 
system that no password is 
assigned to the volume or 
directory of the new file. 

If a password is assigned to the 
volume or directory of the new 
file, enter the password in this 
field. 

The default leaves the new file 
unprotected; a password is not 
necessary to access it. 

To assign a password to the new 
file, enter the word or characters 
(a maximum of 12) you want to 
use for a password. 

The default sets the protection 
level for the file at unprotected 
(15). 

To set the protection for the file 
at a level other than unprotected, 
enter the protection decimal 
value. 
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[Size in sectors 
(default = 0)] 



The default sets the file length 
to 0 sectors. 



To set a size for this file other 
than 0 sectors, enter the number 
of sectors you want to assign to it. 



entered in the File name field 
already exists, the default directs 
the system to prompt you for 
confirmation before overwriting 
the file's contents. 

To overwrite the contents of an 
existing file with the same name 
as you entered in the File name 
field, enter y. 

If a file with the same name as 
you entered in the File name field 
exists and you do not want to 
overwrite its contents, enter n. 
The system cancels the CREATE 
FILE command. 



[Overwrite ok?] 



If a file with the name you 
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CREATE PARTITION Command 

Figure 1 1 CREATE PARTITION Command Fomi 



C reate Partition 

j {Wary Sim (default ■ 20CK)1 "~] | • "| 

(PaRUlm ran (default - BacKgromno)] 



Optional fields: 

[Memory size 
(default = 200K)] 



[Partition name 
(default " 
BackgroundOO)] 



The default sets the partition 
memory size at 200KB. 

To specify the memory size of the 
partition, enter the size in 
K bytes. The partition requires 
1.5KB to store system data 
structures associated with it; 
include this amount in your total 
memory size. 

The default names the partition 
Backgroundnn, where nn begins 
with 00. if you create more than 
one secondary application 
partition with a default partition 
name, the system names the first 
partition BackgroundOO, the 
second partition BackgroundOl, 
etc. 

To specify a name for the 
partition, enter the name. 
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DEBUG FILE Command 

Figure 12 DEBUG FILE Command Form 



P etxig File 
I File naw 



(•rite?] 
[I«age aode?] 



Mandatory field: 
File name 



Enter the run file name. 



Optional fields: 
[Write?] 



[Image mode?] 



The default (no) does not allow 
you to modify the file. 

To allow file changes, enter y. 

The default is no. The system 
interprets the file as it appears 
when BTOS loads it into memory. 

To direct the system to interpret 
the data as it appears in the run 
file, enter y. 
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DELETE Command 

Figure 13 DELETE Command Form 



DBiete . 

I File U3t 1 
{oonflni eacn?] 



Mandatory field: 

File list Enter the name of the file you 

want to delete. 



Optional field: 

[Confirm each?] The default for this field is no; 

the system does not prompt you 
to confirm each file you want to 
delete. If you want to confirm 
each file before the system deletes 
it, enter y. 
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DISABLE CLUSTER Command 

Figure 14 DISABLE CLUSTER Command Form 



OlsAla Clustar 



Optional field: 

[Time interval Specify the number of seconds 

(seconds)] you want the system to wait 

before disabling the cluster. 

The default is 0. 
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DUMP Command 

Figure 15 DUMP Command Form 



(oiMpan file] 
[Oitput file] 
(File eiaren first] 
[File adoress ilalt] 
[Continue on dlf fennces?] 



Mandatory field: 

Input file Enter a file name (for example, 

[SysJ<Acctg>Month). 



Optional fields: 

[Compare file] The default is no comparison; the 

system displays only the input file. 

To compare the input file with 
another file, enter the other file 
name. The system limits the 
display to the file addresses range 
specified in the [File address 
first] and [File address limit] 
fields. 

At the end of the comparison, the 
system displays either the 
message. Differences 
encountered, or the message, No 
differences encottiitered. 



[Output file] The default directs the system to 

only display the comparison; the 
comparison is not saved. 

To write the comparison to a file, 
enter the file name. If the file 
exists, the system discards the 
contents of this file and saves the 
comparison in it. If the output file 
does not exist, the system creates it. 
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(File address 
first] 



[File address 
limit] 



[Continue on 
differences?] 



The default (0) directs the 
system to display a comparison 
starting at the beginning of the file. 

To specify a beginning file 
address for the display or 
comparison, enter the 
hexadecimal number of the file 
address. The final h of the 
hexadecimal number is 
unnecessary. 

The default is the file end. 

To specify an ending file address 
for the display or comparison, 
enter the hexadecimal number of 
the file address. If the value you 
enter is greater than the end of 
the file, the limit is the end of the 
file. 

The default is no. When you use 
the DUMP command in a submit 
file, the system halts the submit 
execution. 

To continue execution if the 
system finds differences while 
executing a submit file, enter y. 
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EDIT Command 

Figure 16 EDIT Command Form 



EOU 

[Your naie] 



Mandatory field: 

File Enter the name of a file you want 

to edit. 



Optional field: 

[Your name] The default is xxxx.ts where 

xxxx is the logged-on user name. 
If you want to use a prefix for 
the .ts file other than the logged- 
on user name, you enter the name 
in this field. If there is no logged- 
on user and you leave this field 
blank, the default is .ts. 
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FILES Command 

Figure 17 FILES Command Form 



Files 

I [n\e list) I 

[Details?] 
[Print file] 



Optional fields: 

[File list] The default is the asterisk wild 

card character. It directs the 
system to display the file names 
in the directory of the current path. 

To display information about 
specific files or files in a 
directory other than that of the 
current path, enter the file 
name(s) or complete file 
specification. You can use the 
wild card character in this field. 

[Details?] The default (no) directs the 

system to display the file name(s) 
only. 

To display details about the 
file(s), enter y. 

[Print file] If you accept the default, the 

system does not store or print the 
FILES information; it appears on 
the screen only. 

To store the information in a file 
from which you can later display 
or print the information, enter a 
file name for the storage file. 

To send the information directly 
to a device such as a printer, 
enter an appropriate device name 
(for example, (LptJ). 
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FLOPPY COPY Command 



Figure 18 FLOPPY COPY Command Form 



Floppy Copy 



[Number of copies] 
[Overwrite OK?J 
[Dual floppy?] 
[Supppress verify?] 
[Device name(s)] 
[Volume 1 password] 
[Volume 2 password] 







Optional fields: 

[Number of copies] The default is unlimited copies. 

To specify the number of copies 
you want to make from each 
master diskette, enter the number. 

[Overwrite ok?] If you accept the default (no 

entry) or enter n, the system 
prompts you to overwrite any 
existing data on the diskette used 
for the copy. 

To overwrite existing data on the 
diskette used for the copy, enter y, 

[Dual floppy?] The default is no for workstations 

with a single floppy disk drive. 

If your workstation has dual 
floppy disk drives and one or 
more hard disk drives, enter y. 
The system makes the copy with 
the master diskette in floppy disk 
drive [fOJ and the duplicate 
diskette in [flj. 
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[Suppress verify?] 



[Device name(s)] 



[Volume 1 password] 



[Volume 2 password] 



The default (no) directs the 
system to reread the information 
on the diskettes and to verify it is 
correct. 

If you do not want the system to 
reread the master and duplicate 
diskettes to verify no errors 
occurred during the copy 
operation, enter y. 

The default is [fO] (lefthand drive) 
[fl] (right hand drive). You accept 
this value unless you have a 
customized operating system with 
different disk drive names. 

If you have a customized 
operating system with disk drive 
names other than [fO] (lefthand 
drive) and [fl] (righthand drive), 
enter the device names in this field. 

The default indicates that the 
source diskette from which you 
are copying does not have a 
password. 

If you want to password protect 
your source diskette, enter a 
password in this field. 

The default indicates that the 
destination diskette will not be 
password-protected. 

If you want to password protect 
your destination diskette, enter a 
password in this field. 
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FORMAT Command 



Figure 1 9 FORMAT Command Form 




[Print to] 
[conflra each?] 
[Title] 

(First page to formt] 
[Last page to fomt] 
[Suppress pege nuMbers?] 
(Ska>ress date?] 
(Suppress tine?) 
[oouDle-space?] 

[Left wetgHn (default 10 spaoes}] 
(Text eldth (default 65 spaces)] 
[Page length (default 66 lines)] 
(Top Migln (default 6 lines)] 
[BottCM Margin (default 6 lines)] 
[Jtb eldth (default 8 spaces)] 
[Si4ipress page ejects beteeen files?) 



Mandatory field: 

File list Enter the file specification, file 



list, or at-file name for the file 
you want to format. 



Optional fields: 
[Print to] 



Thp default directs the system to 



print the formatted file on the 



spooled printer [Spl]. 



To direct the printing to a printer 



other than the spooled printer 



enter one of the following: 



□ the device name of a local 
printer for direct printing 



□ the name of a Scheduling queue 



□ the name of the file in which 

you want the system to write 
the formatted image of the 
input file. Do not enclose this 
name in brackets. 
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[Confirm each?] 



[Title] 



[First page to 
format] 



[Last page to format] 



[Suppress page 
numbers?] 



[Suppress date?] 



[Suppress time?] 



The default is no; the system does 
not prompt you for confirmation 
before formatting the file. 

To receive confirmation prompts 
before the system formats each 
file, enter y. 

The default directs the system to 
print the file name as the title. 

To specify a title for the top of 
each page of the file, enter the title. 

The default is page one of the 
file. 

To specify the first page you 
want formatted, enter the number 
of the page. 

The default is the last page of the 
file. 

To specify the last page you want 
formatted, enter the number of 
the page. 

The default is no; the system 
inserts page numbers at the top of 
each page of the file. 

To suppress the printing of page 
numbers at the top of each page 
of the file, enter y. 

The default is no; the system 
inserts the date at the top of each 
page of the file. 

To suppress the printing of the 
date at the top of each page of 
the file, enter y. 

The default is no; the system 
inserts the time at the top of each 
page of the file. 

To suppress the printing of the 
time at the top of each page of 
the file, enter y. 
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[Double-space?] 



[Left margin (default 
10 spaces)] 



[Text width (default 
^5 spaces)] 



[Page length (default 
66 lines)] 



[Top margin (default 
6 lines)] 



[Bottom margin 
(default 6 lines)] 



[Tab width (default 
8 spaces)] 



The default is no; the system 
single spaces the lines of the file 
text. 

To specify double-spacing of the 
lines of the file text, enter y. 

The default sets a left margin 
of 10 spaces on the printed page. 

To set the size of the left margin, 
enter the number of spaces for 
this margin. 

The default sets the text width 

at 65 spaces. 

To set the text width for the file, 
enter the number of spaces you 
want it to occupy. 

The default sets the page 
length at 66 lines. 

To set the page length, enter the 
number of lines you want per 
page, including the top and 
bottom margins. 

The default leaves six blank 
lines for the margin at the top of 
each page. 

To specify the size of the margin 
at the top of each page, enter the 
number of blank lines to allow for 
the margin. 

The default leaves six blank 
lines for the margin at the bottom 
of each page. 

To specify the size of the margin 
at the bottom of each page, enter 
the number of blank lines to allow 
for the margin. 

The default sets eight spaces 
between tab stops. 

To set tab stops, enter the number 
of spaces to allow between them. 
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[Suppress page ejects 
between files?] 



The default is no; the system 
starts a new page for each file. 

To print the files as continuous 
text, enter y. 
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INSTALL PROTECTED MODE Command 

Figure 20 INSTALL PROTECTED MODE Command Form 

Install Protected Mode 

[Maximum number of protected 
processes] 

[Maximum number of concurrent 
protected mode messages] 

[Maximum number of Mover Server 
segments] 




Optional field: 



It is not necessary to enter any 
values unless you have a 
configuration of protected mode 
programs that exceed the default 
resource allocations. 



[Maximum number of 
protected processes] 

[Maximum number of 
concurrent protected 
mode messages] 



[Maximum number of 
Mover Server 
segments] 



The default value for this field 
is 10 protected processes. 

The default value for this field 
is 100 small protected mode 
messages and 25 large protected 
mode messages. 

The default value for this field 
is 200 mover server segments. 

See the BTOS Protecte.d Mode 
Operating System Server (PMOSS) 
Installation Guide for more 
information. 



Commands 



1-35 



INSTALL SPOOLER Command 

Figure 21 INSTALL SPOOLER Command Form 



i nstall spooler 

1 tspooler configuration file) | {[ 



Optional field: 

[Spooler Enter the name of the custom 

configuration file] Spooler Configuration file. 
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INSTALL TELEPHONE SERVER Command 

Figure 22 INSTALL TELEPHONE SERVER Command Form 



Install Telephone Server 



[Configuration file] 




Optional field: 

[ConHguration file] If this field is left blank, tlie 

default configuration file, 
(sysl<sys>TmConfig.sys. is used 
to invoke the Telephone Server. 

If you enter a valid configuration 
file in this field, the information 
is used by the Telephone Server 
system service for the generation 
of dial characters, ringing, etc. 

See the BTOS Voice Services 
Programming Reference Manual 
for more information. 
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IVOLUME Command 

Figure 23 IVOLUME Command Form 



IVolume 



Device name 




(Device password] 
Volume name 
(Volume passwoni] 
(System Image (default - 0)] 
(Log tile (defaun - 0)] 
(Crash file (default > 0)] 
[Max. diroctorles) 
(Max. Mes on volume] 
(Primary Hie headers only?] 
(Max. files in Sys Directory] 
(Sys Directory password] 
(Write protect Sys Directory?] 
(Suppress format of medium?] 
(Surface tests] 
(DelNjg?] 
(Log file] 

(Extended floppy tracks?] 
[Hard disk type code (default « A)] 
[Use ECC format?] 
(Bad spots (See Doc.)] 



Mandatory fields: 
Device name 



Volume name 



Enter the name of the device that 
contains the disk you want to 
format. 

Enter a name (a maximum of 12 
characters) to identify the 
volume. This name must not 
duplicate any other volume or 
device name. 



Optional fields: 

[Device password] The default leaves unprotected 

the device that contains the disk 
you are initializing; no password 
is necessary to access it. 

To assign a password to the 
device, enter the word or 
characters (a maximum of 12) you 
want to use for the password. 
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[Volume password] 



[System Image 
(default = 0)] 



[Log file 
(default - 0)] 



The default leaves the volume 
unprotected. No password is 
necessary to access it, and none of 
its directories or files can have 
passwords. 

To assign a password to this 
volume, enter the word or 
characters (a maximum of 12) you 
want to use for the password. 

The default allocates 0 sectors 
for the system image. 

To initialize a nonsystem disk, 
accept the default. 

To initialize a system disk with a 
standard system image, enter 512. 

To initialize a system disk with a 
nonstandard system image, you 
must enter the number of sectors 
required for the system run file. 

For an expanded system, allow 
enough sectors to support another 
BTOS run file. You cannot expand 
the number of sectors later 
without reinitializing the disk. 

The default directs the system to 
allocate 0 sectors for the log file. 

The system writes log entries to 
the system disk only. If this 
volume does not contain a system 
image, accept the default. 

To specify the size of the log file, 
enter the number of sectors to 
allocate for it (2 is recommended). 
If the log file overwrites existing 
entries before it is convenient to 
print, enter a larger number in 
this field. 
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[Crash file 
(default = 0)] 



[Max. 

directories] 



[Max. files on 
volume] 



[Primary file 
headers only?] 



[Max. files in 
Sys Directory] 



After a system crash, 
bootstrapping dumps the entire 
memory contents into a Crash 
Dump file which you specify. This 
file helps determine the cause of 
the crash. 

The default directs the system to 
allocate no sectors for the Crash 
Dump file. 

To create a Crash Dump file, 
enter two sectors for each 1KB of 
memory you want to dump. 

The default directs the system to 
set the maximum number of 
directories for this volume, 
according to the volume size. To 
specify the maximum number of 
directories, enter the number. 

The default sets the maximum 
number of files for this volume, 
according to the volume size. 

To specify the maximum number 
of files, enter the number. 

The default (no) directs the 
system to allocate space for both 
primary and secondary File 
Header Blocks. 

To conserve disk space, enter y to 
allocate space for a primary File 
Header Block only. 

The default directs the system to 
set the maximum number of files 
in the <Sys> directory, according 
to the volume size. 

To specify the maximum number 
of files, enter the number. Allow 
for more files than needed; file 
system performance degrades if 
the directory exceeds 80% 
capacity. Remember that the 
system files reside in the <Sys> 
directory. 
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[Sys Directory 
password] 



[Write protect 
Sys Directory?] 



[Suppress format 
of medium?] 



[Surface tests] 



The default leaves the files in the 
<Sys> directory unprotected; no 
password is necessary to access it. 

To assign a password to the 
<Sys> directory, enter the word 
or characters (a maximum of 12) 
you want to use for the password. 

The default is no; the system does 
not set the protection level of the 
files in the <Sys> directory to 
modify protected. 

To set the default file protection 
level of the files in the <Sys> 
directory to modify protected, 
enter y. You must have specified 
previously both a volume and a 
<Sys> directory password. 

The default (no) does not reduce 
the time required to reinitialize a 
previously formatted volume. You 
should accept the default if you 
are initializing a new disk. 

To reduce the time required to 
reinitialize a medium that was 
previously a formatted volume, 
enter y. 

A surface test writes and reads 
each sector on the disk to ensure 
that it is defect-free. 

You should run surface tests the 
first time you initialize floppy 
diskettes. Do not use any floppy 
diskettes that have surface errors. 

The default values are 1 test for 
floppy diskettes, 1 for initialized 
hard disks, and 8 for uninitialized 
hard disks. 

If you want more tests than the 
default, enter the number you 
want. 
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[Debug?! 



[Log file] 



[Extended floppy 
tracks?] 



[Hard disk type code 
(default = A)] 



The default is no; the system 
does not display debugging 
information. 

To display debugging information 
for system programming, enter y. 

The log file receives a report of 
the IVOLUME operation. If this 
file does not exist, the system 
creates it; if it exists, the system 
automatically appends the log to it. 

The default directs the system to 
display the log only on the screen. 

To receive a printed log of the 
volume initialization, enter the 
name of the file that you want to 
receive this information. 

The default (no) directs the 
system to create a system 
diagnostic file on the innermost 
(extended) six tracks of a floppy 
diskette. 

To use these innermost tracks for 
storage, enter y. 

This field applies only to the 
initiahzation of B 26, B 27, B 28, 
and B 38 hard disk drives. If you 
are reinitializing a hard disk 
drive, no entry is required in this 
field. 

Refer to Managing Data in the 
Bros Standard Software 
Operations Guide for a list of the 
parameters of available types of 
hard disk drives. 
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[Use EGC format?] If the field is left blank, the 

system uses the existing CRC or 
ECC format. If the controller 
supports ECC and there is no 
previous format information on 
the disk drive, IVOLUME selects 
the EGG format. 

If you enter y, BTOS uses EGG 
when formatting and writing to 
the disk. If the controller does not 
support the ECC capability or if 
the current OS is not at least 
revision 8.0, BTOS uses the 
existing CRC format. 

Note: if the controller supports ECC, drives 
larger than ;40IVU)':S must use ECC. The error 
message, Drive t/iis size must lie formatted 
witii ECC. displays if the capacity is greater. 

[Bad spots (See This field applies only to hard 

Doe.)] disk drives. Each drive comes 

with a report of bad spots. Locate 
and read the media defect report 
that came with your system. 

The default indicates to IVOLUME 
that no bad spots exist on the disk. 
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LCOPY Command 

Figure 24 LCOPY Command Form 

LCopy 

[Fils pief lx(e9) froa] 
[FUt pfBrix(es) to] 
[File 9UfflX{M)) 

(OMnrlte ac?) 
(Oonrlni wort?] 
[ContlnuB an ermr?] 



Mandatory field: 
File list 



Enter the name of the file you 
want to copy. 



Optional fields: 

[File prefix(es) 
from] 



[File prefix(es) to] 



The default directs the system to 
use the volume, directory, and file 
prefix (if any) of the current path 
as the file-from prefix. 

To add a prefix(es) to the name(s) 
you entered in the File list field, 
enter the characters you want to 
use as a prefix. 

The default directs the system to 
use the volume, directory, and file 
prefix (if any) of the current path 
as the file-to prefix. 

To add a prefix(es) to the name(s) 
you entered in the File list field, 
enter the characters you want to 
use as a prefix. 

If you made only one entry in the 
[File prefix(es) from] field, the 
system copies each file with that 
prefix in the File from field to a 
new file with the prefixes 
specified in this field. 
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[File suffix(es)] 



[Overwrite OK?] 



[Confirm each?] 



[Continue on error?] 



If you did not make an entry in 
the [File prefix(es) from] field, 
the system copies each file of the 
current path listed in the File 
from field to a new file with the 
prefixes specified in this field. 

The default directs the system to 
use the existing file suffixes (if 
any). 

To apply a suffix to the source 
and destination file specification, 
enter the characters to use as a 
suffix. 

If the destination file already 
exists and you accept the default 
(no entry) or enter n, the system 
prompts you for confirmation 
before it overwrites the existing 
file. 

To direct the system to overwrite 
the destination file if it already 
exists, enter y. 

If you accept the default or enter 
n, the system does not prompt 
you for confirmation of each copy 
operation. 

To receive confirmation prompts 
for each copy operation, enter y. 

If you accept the default, LCOPY 
stops when it encounters an error 
and the system prompts you for 
confirmation to continue. 

To have the system report errors 
and continue, enter y. 

To have LCOPY stop when it 
encounters an error, enter n. 
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[Verify copy?] 



The default is no; the system does 
not verify that the copies are 
correct. 

To have the system verify that 
the copies are correct by reading 
the source and destination files 
and comparing them, enter y. 
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LIST Command 

Figure 25 LIST Command Form 



List 

i [File lUx] I t;!;i;i;:ji;i;!;;^!i:;;;ii;;:i!:i^:^^ 



Optional field: 

[File list] If you accept the default by 

leaving the field blank, the 
system lists the files in the 
directory of the current path. 

To list files in other volumes or 
directories, enter the file 
specif ication(s). 
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LOGIN Command 

Figure 26 LOGIN Command Form 



Login 

[Directory] 
[oefaat flu prefix] 
(Passwnil 

(NOdB) 



Optional fields: 

[Volume] The default directs the system to 

use the currently logged-in 
volume as the volume name. 

To change the volume name, enter 
the name of the volume you want 
for the path. You need not enclose 
your entry in square brackets. 



[Directory] The default directs the system to 

use the currently logged-in 
directory as the directory name. 

To change the directory name, 
enter the name of the directory 
you want for the path. You need 
not enclose your entry in angle 
brackets. 



[Default file prefix] The default directs the system to 

use the currently logged-in default 
file prefix (if any). 

To assign a default file prefix 
name for use as part of a filename 
in calling up a file, enter a name 
ending with a right angle bracket, 
for example, mgr>. 

To remove an assigned default file 
prefix from the pathj enter ' ' 
(two single quotation marks with 
no space between) in this field. 
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[Password] The default directs the system to 

use the password you assigned (if 
any) when you signed onto the 
system. 

If the directory has an assigned 
password, enter its volume or 
directory password to gain access 
to the directory. 

To remove an assigned password 
from the path, enter ' * (two single 
quotation marks with no space 
between) in this field. 

[Node] This field applies only to 

workstations with B-NET 
(network systems). 

If you accept the default, the 
system uses the currently 
logged-in node (if any). 

To assign or change a node name, 
enter the appropriate name. You 
do not need to enclose the name 
in braces. 

To remove a node name from the 
path, enter * ' (two single 
quotation marks with no space 
between) in this field. 
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MAINTAIN FILE Command 

Figure 27 MAINTAIN FILE Command Form 



n aintaln File 
[input ftieT 



[output flies] 
[Log file] 

[Renove deleted leooids?] 
[Sifpress oonflxwtlon?] 



Mandatory field; 
Input files 



Enter one or more data files. 



Optional fields: 
[Output files] 



[Log file] 



[Remove deleted 
records?! 



The default varies depending on 
your input files: If all files are 
readable using DAM, the output 
file is a DAM file; otherwise the 
output file is an RSAM file. If an 
output file exists, the system 
overwrites the file. 

To change the default, enter a file 
name. 

The default directs the system to 
only display the log. To direct the 
system to save the log, specify a 
file name. You can then print the 
log by printing that file. 

The default value is no. If the 
output file is an RSAM file, the 
system ignores deleted and 
malformed records. If the output 
file is a DAM file, the system 
places deleted and malformed 
records in the output file. 

To override the default for a DAM 
file, enter y in this field. 
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[Suppress 
confirmation?] 



The default value is no. When a 
malformed record appears in the 
input file, the system displays a 
message specifying its file address 
and length. 

To override the default, enter y in 
this field. 
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MAKE TRANSLATION FILE Command 

Figure 28 MAKE TRANSUTiON FILE Command Form 



mai Translation File 
I souros f 11* nm 



Translation file ( 



Mandatory fields: 
Source file name 



Translation file 
name 



Enter the name of the source file 
you want to convert into a 
Translation file. 

Enter a name for the Translation 
file. 
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MERGE Command 

Figure 29 MERGE Command Form 



Merge 



Input file 



Output files 
Keys 
[Log file] 

[Suppress confirmation?] 



Mandatory fields: 
Input file 

Output nies 
Keys 



Enter the name(s) of the file(s) 
you want to merge. 

Enter the name(s) of the file(s) to 
which you want the output 
written. 

This field specifies how the sort 
keys are embedded within each 
record. 



Optional fields: 
[Log file] 



[Suppress 
confirmation?] 



Specifies the file name to which 
the status report and the merge 
statistics are written. 

If you enter y, the MERGE 
operation skips any corrupt input 
records and searches for the next 
valid record. 

If you enter n, the MERGE 

operation skips any corrupt input 
records and displays a message 
inquiring if you want to continue 
or terminate the MERGE 
operation. 
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For more information, refer to the 
BTOS Sort/Merge Operations 
Reference Manual. 
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NEW COMMAND Command 

Figure 30 NEW COMMAND Command Form 



New Command 

Command name 

Run file 
[Field names] 
[Description] 
[Overwrite OK?] 
[Case (default - GO)] 
[Command file] 



Mandatory fields: 

Command name Enter the new command name. 

Run file Enter the complete run file name 

([VolName]<DirName> FileName) 
or, if the command is an 
Executive Intrinsic Command, 
enter the appropriate symbol 
(refer to Adding Executive 
Commands in the BTOS Standard 
Software Operations Guided 



Optional fields: 
[Field names] 



[Description] 



[Overwrite OK?] 



The default is no field names. 

To specify parameter fields, enter 
the name of each field. Enclose 
each field name in single 
quotation marks. 

The default is no HELP 
description. To specify a HELP 
description, enter a description 
enclosed in single quotation 
marks. 

The default (y) directs the system 
to prompt you for confirmation 
before overwriting an existing 
command. 
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If you enter n, and the command 
already exists, the system cancels 
the new command. 



[Case (default 
00)1 



[Command file] 



Case values specify which 
command called the run file when 
more than one path of execution 
exists within the run file. (The 
run file queries the case value.) 
The default is 00. 

Enter the case value (if 
necessary). Enclose the case value 
in single quotation marks. 

The default directs the system to 
add this command to the 
command file currently in use. 

To add this command to a 
different command file, enter the 
name of the command file. 
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PATH Command 

Rgure 31 PATH Command Form 



Path 



[voluiel 



31 



[Directory) 
(Default file prefix) 
(PasMotd) 
iNDdi} 



Optional fields: 
(Volume] 



The default directs the system to 
use the currently logged-in 
volume as the volume name. 

To change the volume name, enter 
the name of the volume you want 
for the path. You do not need to 
enclose your entry in square 
brackets. 



[Directory] The default directs the system to 

use the currently logged-in 
directory as the directory name. 

To change the directory name, 
enter the name of the directory 
you want for the path. You do not 
need to enclosie the niame in angle 
brackets. 



[Default file prefix] The default directs the system to 

use the currently logged-in default 
file prefix (if any). 

To assign a default file prefix 
name for use as part of a filename 
in calling up a file, enter a name 
ending with a right angle bracket, 
for example, mgr>. 

To remove an assigned default file 
prefix from the path, enter * ' 
(two single quotation marks with 
no space between) in this field. 
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[Password] The default directs the system to 

use the password you assigned (if 
any) when you signed onto the 
system. 

If the directory has an assigned 
password, enter its volume or 
directory password to gain access 
to the directory. 

To remove an assigned password 
from the path, enter ' ' (two single 
quotation marks with no space 
between) in this field. 

[Node] This field applies only to 

workstations with B-NET 
(network systems). 

If you accept the default, the 
system uses the currently 
logged-in node (if any). 

To specify a node name, enter the 
appropriate name. You do not 
need to enclose the name in 
braces. 

To remove a node name from the 
path, enter * * (two single 
quotation marks with no space 
between) in this field. 
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PLAYBACK Command 

Figure 32 PLAYBACK Command Form 




Mandatory field: 
File 



Enter the name of a file. 
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PLOG Command 

Figure 33 PLOG Command Form 



PLog 

I lEirar type (Cr.MM>.CI,l8)l | liiiijjjiiiiijlijjjijijiriiiiiijiiilijiiill;^ 

(Print to] 

(volun DM} 

[Wtar MM/nwl 



Optional fields: 

[Error type (Cr, B, The default directs the system to 
In, D, CI, Is)] display all entries in the log file. 

To specify the type(s) of errors 
you want the system to display, 
enter one of the following codes: 



Error Code Code 

system crashes Cr 

system boot errors B 

system initialization errors In 

disk errors D 

cluster communication errors CI 

ISAM errors Is 



[Print to] The default directs the system to 

display the log file on the screen. 

To write the log to a file or print 
it, enter the name of the 
destination file or the printer 
device name. 

[Volume name] The default directs the system to 

display the log file for the current 
[Sys] volume. 

To specify the volume of the log 
file, enter the volume name. 
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[After date/time] 



The default directs the system to 
display all the log file entries 
after the earliest date and time 
recorded in the file. 

To display log file entries after a 
particular date/time, enter the 
starting date/time. 
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PRINT Command 

Figure 34 PRINT Command Form 



Print 

IQUM nan (default ■ SPL)) 
[lUter or ooplm] 
(OBlAta art«r |iirintlf47] 
[Speelal fonn nan] 
(Print aheel nnal 
(Printing woOb] 
(Align fonir?] 
(After data/tin] 
(Security aade?) 
(priority] 
(Conflm 0acfi7] 



Mandatory field: 
File list 



Enter the name of the file you 
want to print. 



Optional fields: 

[Queue name 
(default » SPL)] 



[Number of copies] 



[Delete after 
printing?] 



The default directs the system 
to use [Spl] as the scheduling 
queue. 

To specify the scheduling queue 
that contains the queue entry 
generated by this print request, 
enter the queue name. The name 
must match a queue name defined 
for the system. 

The default directs the system to 
print one copy. 

To specify the number of copies 
of the file to print, enter the 
number. 

If you accept the default (no 
entry) or enter n, the system does 
not delete the file(s) after 
printing it. 
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[Special forms name] 



[Print wheel name] 



[Printing mode] 



[Align form?] 



[After date/time] 



[Security mode?] 



To direct the system to delete the 
file(s) after printing it, enter y. 

If you accept the default, the 
printer does not pause before 
printing to load special paper. 

To use special paper to print the 
file, enter the name (a maximum 
of 12 characters) of the paper. 
The printer pauses before printing 
so that you can load this paper. 

The default does not specify a 
particular print wheel. 

To use a specific print wheel, 
enter the name (a maximum of 12 
characters) of the print wheel. 
The printer pauses before printing 
so you can install the print wheel. 

The default is the ASCII mode. 

To specify the Plotter mode, enter 
the letter p. 

To specify the Binary mode, enter 
the letter b. 

The default is no; the printer does 
not pause for forms alignment. 

To direct the printer to pause 
after printing the first page so 
that you can align the paper, 
enter y. 

The default directs the system to 
print the file as soon as possible. 

To specify the earliest date/time 
for the system to print the file, 
enter the date/time in this format: 

Mori Jun 3 1985 8:00 pm 

The default is no; the printer does 
not pause for a password entry 
before printing the file(s). 
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[Priority] 



[Confirm each?] 



To direct the printer to pause for 
a password entry before printing 
the file, enter y. 

Scheduling queue priorities are 
0-9, with 0 as the highest. 

The default sets the priority at 5. 

To assign the file a priority in the 
Scheduling queue, enter the 
priority number. 

The default is no; the system 
prints the file(s) without 
prompting you for confirmation. 

To receive prompts to confirm the 
printing of the file(s), enter y. 
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RECORD Command 

Figure 35 RECORD Command Form 



Recort 

I File to record on | IjiiijijijiHiiiiiijijiiijijiiiii;!;!:^ 



Mandatory field: 

File to record on Eiiter the file name that specifies 

the file containing the commands 
you are recording. 
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REMOVE COMMAND Command 

Figure 36 REMOVE COMMAND Command Form 



{ Cowano rem \ ^^^^^^^^^^^j^^^^^^^^^^^^^^^^^W^ 
[a— «d file) 



Mandatory field: 

Command name Enter the full name of the 

command you want to remove or 
its unique abbreviation. 



Optional field: 

[Command file] If you accept the default by 

leaving this field blank, the 
system removes the command 
from the command file currently 
in use. 

To remove a command from a 
command file not currently in use, 
enter the file specification for the 
command file in this field. 
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REMOVE DIRECTORY Command 

Figure 37 REMOVE DIRECTORY Command Form 



Rewove Dlractory 

[Volun or ulxectory passwid] 
(oem» all flies in dliectory?] 
(Oanfln each Mle deleting?] 



Mandatory field: 
Old directory name(s) 



Enter the name of the directory 
you want to delete. 



Optional fields: 

[Volume or directory 
password] 



[Delete all files 
in directory?] 



[Confirm each while 
deleting?] 



The default indicates that a 
password is not assigned to the 
directory(ies) or its volume(s). 

If the directory or its volume has 
a password, enter the password in 
this field. 

The default is no; the system does 
not delete any files in any 
directories. 

To delete all the files in all the 
directories listed in the Old 
directory name(s) field, enter y. 

The default is no; the system does 
not prompt you to confirm the 
deletion of each file. 

To receive a prompt to confirm 
the deletion of each file in each 
directory, enter y. 



Commands 



1-67 



RENAME Command 



Figure 38 RENAME Command Form 



I Old file 



Nm file nam 
[Ouemlte ok?] 
[oonfln eaon?] 



Mandatory fields: 
Old file name 

New file name 



Enter the name of the file you 
want to change. 

Enter the new name for the file. 



Optional fields: 
[Overwrite ok?] 



The default is no entry. If you 
accept the default and the name 
you enter in the New file name 
field already exists, the system 
displays the following when you 
complete the command form and 
press GO: 

File [File name] already exists 
Overwrite? 

(Press GO to confirm, CANCEL 
to deny, or FINISH to stop 
command.) 

If you enter n in this field, the 
system does not perform an 
overwrite operation. 

To assign the name entered in the 
New file name field to the file in 
the Old file name field, enter y. If 
a file with the New file name 
parameter already exists, the 
system overwrites that file and 
assigns the New file name 
parameter to the Old file name file. 
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[Confirm each?] 



The default is no; the system does 
not prompt you to confirm each 
RENAME operation. 

To receive prompts to confirm 
each rename operation, enter y. 
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REPLAY Command 

Figure 39 REPLAY Command Form 



Wiiaay ' ^ ^ 'I '''''''''' ^ ''' '^^ ' ^\:\^ 

(voir nan] 



Mandatory field: 

File Enter the same name of the file 

you created or edited with the 
EDIT command, or the name of a 
file in which you want to save the 
replay session. 



Optional field: 

[Your name] If you accept the default, the 

system uses the typescript file .ts 
if no user name was logged on 
when you activated the Editor, or 
the default user.ts file if a user 
name was logged on. 
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RESTORE Command 

Figure 40 RESTORE Command Form 



Bestow ' 

[Filt list fXM] 

(File list to) 
[OMTwrlts ok?) 
(oonrira eacn?) 
(Sequence nuetier] 
(Nnge •1th axlttlng flls?) 
[UK files only?) 
(Log flu) 



Optional fields: 

[Archive File] The default is the file name, 

[Archive]<Sys>.01. 

To specify an archive file created 
with BACKUP VOLUME or 
SELECTIVE BACKUP that has a 
name other than Archive, enter 
the file name. 



[File list from] If you accept the default, the 

system restores all the files on the 
archive file. 

To specify a list of files you want 
to restore, enter the file names in 
the following format: 
<DirName>FileName. Do not use 
volume names. 



[File list to] If you accept the default, the 

system restores the files to the 
directory and file they were in 
when they were archived, but 
places them in the currently 
logged-in volume. 
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To restore the files to a new file 
destination, enter the new file 
name(s) in the following form: 

lVolNaineJ<DirName>FileName 

The volume and directory names 
are optional. If you enter only a 
file name, the system restores the 
files to the currently logged-in 
volume. 

[Overwrite ok?) If you accept the default (no 

entry) or enter n, the system 
prompts you for confirmation 
before it overwrites any existing 
file of the same name. 

To overwrite any existing file of 
the same name before restoring a 
new one, enter y. 

[Confirm each?) If you accept the default (no 

entry) or enter n, the system does 
not prompt you for confirmation 
before restoring each file. 

To receive prompts for 
confirmation before restoriiig each 
file, enter y, 

[Sequence number] The default is 1 (the first volume 

of the archive file). 

To specify the volume you want 
to begin the RESTORE operation 
with, enter the sequence number 
of the volume. 

If you accept the default (no 
entry) or enter n, the system 
overwrites the sectors of the 
target file with zeros when it 
detects any input/output errors 
on the archive file. 

To bypass overwriting sectors of 
the target file when the system 
detects input/output errors on 
corresponding sectors of the 
archive file, enter y. 
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[List files only?] 



[Log filel 



The default is no; the system 
restores the files indicated. 

To list the files on the archive file 
only, not restore them, enter y. 

If you accept the default, the 
system displays the log on the 
screen only. 

To write a report of the RESTORE 
operation to a file, enter the name 
you want to use for the file. 

If a log file currently exists, the 
system appends the log to it. If a 
log file does not exist, the system 
creates one with the name you 
specify here. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 
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RUN Command 



Figure 41 RUN Command Form 



I Run nit 




(GM] 
[ft— uiUl 
(ParaBter l] 
(Paraaeter 2] 
[Parawter 3) 



(paraintar 16] 



Mandatory field: 

Run file Enter a run file name. 

Optional fields: 



[Case] 



The default is 00. 

To change the default, you enter a 
two-digit case value (a string to 
identify the command if more 
than one command can call the 
run file). 



[Command] 



The default is no command name. 

To specify a command name, you 
enter it in this field. 



[Parameter 1] 



The default is none. 



[Parameter 16] 



You enter parameters for the 
first command form field here in 
order (up to 16). 
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RUN FILE Command 

Figure 42 RUN FILE Command Form 

Run File 
[ParsMtan] 



Mandatory field: 

File name Enter a run file name. 



Optional field: 
[Parameters] 



The default is no parameter. To 
specify parameters, enter them in 
this field. 
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SCREEN SETUP Command 

Figure 43 SCREEN SETUP Command Form 



Screen Setup 



I {Reverse video?! 



(Urge characters?] 
(Screen lerigth (default - full sctmh)) 
(Supress character attributes?] 
tSupras* pausa balwaan pagas?) 
[Color (041., Groan)] 
(Seroon Hmoout (in minutot)) 



Optional fields: 
[Reverse video?] 



[Large characters?] 



[Screen length 
(default = full 
screen)] 



[Suppress character 
attributes?] 



The default is no; the system 
displays light characters on a 
dark background. 

To display dark characters on a 
light background, enter y. 

This field apphes only to B 22 
and B 27 workstations, which 
have wide screen capabilities. 

The default is no; the system sets 
the screen width at 132 columns. 
To set the screen width at 80 
columns, enter y. 

The default sets the screen 
length at full screen. 

To specify the screen length, 
enter the desired length in 
number of lines. 

The default is no; the system does 
not suppress character attributes 
and the command form parameter 
fields remain in reverse video. 

To suppress character attributes 
and eliminate the reverse video 
highlight from command form 
parameter fields, enter y. 
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[Suppress pause 
between pages?] 



[Color (e.g,, 
Green)] 



[Screen timeout 
(in minutes)] 



The default is no; the system 
prompts you to press the NEXT 
PAGE key before scrolling any 
information off the screen. 

To suppress a pause between 
pages displayed on the screen, 
enter y. 

This field applies to color 
workstations only. 

The system sets this parameter to 
the color you specified most 
recently. 

To specify a color other than 
green, enter the name of the color. 

The default does not use the 
screen timeout feature; the screen 
remains on as long as the 
workstation is on. 

To use the screen timeout feature, 
enter the number of minutes delay 
after an entry before the system 
turns off the screen. 



Commands 



1-77 



SELECTIVE BACKUP Command 



Figure 44 SELECTIVE BACKUP Command Form 



Selective Backup 


iFile I'St 1 




[Incremental from (e.g.. Mon Jun l 1981 8:00 pm)] ' 




[Confirm eaci)?] 




[Archive file) 




(Delete existing archive lite?) 




[Log file) 




[Verify write?] 





Mandatory field: 

File list Enter the name of the files you 

want to backup. 



The default directs the system 
to backup all files. 

To backup files modified on or 
before a specific date, enter the 
date. The time is optional. If you 
do not specify a time, the system 
backs up all files from 12:00 AM 
(midnight) of the specified day. 

[Confirm each?] The default is no; the system 

backs up the files without 
individual confirmation. 

To receive confirmation prompts 
before the system copies a file, 
enter y. 

[Archive file] If you accept the default, the 

system creates an archive file 
named (ArchiveJ<Sys>.nn, where 
nn represents a number that the 
system supplies. 



Optional fields: 

[Incremental from 
(e.g., Mon Jun 1 
1981 8:00 pm)l 
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To assign a name other than 
Archive to this file, enter the 
name you want to use. You must 
also specify a directory name so 
that adding a sequence number 
produces a valid file specification. 
For example, you specify 
{XYZI<Sys> to get IXYZl<Sys>.01, 
{XYZ]<Sys>.02, etc., or 
(XYZl<Sys>ABC to get 
[XYZl<Sys>ABC.01. 
[XYZJ<Sys>ABC.02, etc. 

[Delete existing If you accept the default (no 

archive file?] entry) or enter n and the archive 

file already exists, the system 
displays the following prompt: 

File already exists. Delete? 
(Press GO to confirm, CANCEL 
to deny, or FINISH to return to 
the Executive.) 

To automatically overwrite the 
existing archive file, enter y. 

[Log file] The default directs the system to 

display the log on the screen only. 

To write a report of the backup 
operation to a file, enter the file 
name (for example, BackupLog). 
If the file already exists, the 
system appends the log to it; if it 
does not exist, the system creates it. 

To send the log file directly to a 
printer, enter a device name (for 
example, [Lpt]). 
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[Verify write?] The default is no; the system does 

not perform a physical read after 
each write to insure that the 
file(s) you are backing up are the 
same as the previously backed up 
file(s). 

Note: It is probably not necessary to fill in 
the [Verify write?] field if you have verified 
the hard disk or diskette for bad spots using 
the IVARCHIVE command. 

To automatically verify each read 
and write operation for the file(s) 
that you are backing up, enter y. 
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SET DIRECTORY PROTECTION Command 



Figure 45 SET DIRECTORY PROTECTION Commanil Farm 



set Director y Protection 
[ Olrectory" 



(e.g., sys) 



[volun or directory password] 
(Nee protection level (e.s., IS)) 
fNee passeont] 



Mandatory field: 
Directory name 



Enter the name of the existing 
directory whose protection you 
want to change. 



Optional fields: 

[Volume or 
directory password] 



[New protection 
level (e.g., 15)] 



[New password] 



The default indicates that this 
directory and its volume currently 
do not have passwords. 

If this directory currently has a 
password, enter it or its volume 
password in this field. 

The default is no change. 
To change the existing default file 
protection level for this directory, 
enter the decimal value for the 
new protection level. 

The default is no change to the 
current password status. 

To add or change a password, 
enter the word or characters (a 
maximum of 12) that you want to 
use for the password. 

To delete an existing directory 
password, enter ' * (two single 
quotation marks with no space 
between) in this field. 
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SET FILE PREFIX Command 

Figure 46 SET FILE PREFIX Command Form 



set File Prefix 

I Default file prefix | 



Mandatory field: 

Default file prefix Enter the name of the file prefix 

you want the system to use as a 
default. 
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SET PROTECTION Command 

Figure 47 SET PROTECTION Command Form 



Set Protection 

NM (Htotaetion laval (e.g., 15} 
(Nw passwrd] 
(Oonflni each?} 



Mandatory fields: 

File list Enter the name of the file or list 

of files you want to protect. If the 
file is in a volume or directory 
other than that of the current 
path, you must enter a full file 
specification. 



New protection 
level (e.g., 15) 

Optional fields: 
[New password] 



Enter the decimal value of the 

protection level you want to 
assign to the file(s). 



If you accept the default, the 

system does not assign a 
password to the f ile(s). 

To assign a new password to the 
file(s), enter a word or characters 
(a maximum of 12) that you want 
to use for a password. 

If you entered a protection level 
that requires a password in the 
New protection level field, you 
must enter a parameter in this 
field. 



[Confirm each?] If you accept the default (no), the 

system does not prompt you for 
confirmation before setting the 
protection level of each file. 

To receive confirmation prompts 
before a protection level is set for 
each file, enter y. 
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SET TIME Command 

Figure 48 SET TIME Command Form 



set nm 

i Date/Tfe (e.g., Hon Jun l. M61 8:00 pw) | ^ 



Mandatory field: 
Date/Time 



You should use the following 
guidelines when you enter a 
parameter in this field: 



Day of week 



Month 



Day of Month 



Year 



Abbreviated 
Form 



Time 



Enter the current 
day. 

Enter the current 
month. 

Enter a number 
between 1 and 31. 

Enter the current 
year. 

You can enter the 
current Month, day, 
and year combined in 
an abbreviated form 
(for example, 6/4/85 
for June 4, 1985). 

Enter the current 
hour, minute, and, 
optionally, time 
qualifier in the 
format: 7:00 AM. 

You can use the 
24-hour notation of 
two digits to specify 
the hour (for 
example, 14:22). 
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SOFTWARE INSTALLATION Command 



Figure 49 SOFTWARE INSTALLATION Command Form 



Software Installation 



[Cmd file] 



[Files to] 
[Install file] 



Optional fields: 
[Cmd File] 



[Files to] 



[Install file] 



The default is the standard 
system command file, 
[Sysl<Sys>Sys.cmds. 

To specify a different command 

file, enter the file name or 
complete file specification. 

The default is the system 
directory. 

To specify a different directory, 
enter the directory name. 

The default installation file is 
{fO]<Sys>Install.sub. 

If the application program uses a 
different installation file, specify 
the file name in this field. 
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SORT Command 

Figure 50 SORT Command Form 



sort 



I Input flies 



Output file 
Keys 

(Stable sort?] 
[itoTk File 1] 
[eoiK File 2) 
(Log file) 

[Suppress oonfliMtlan?] 



DC 



Mandatory fields: 
Input files 

Output file 



Enter the name of the file(s) that 
you want to sort. 

Enter the name of the file(s) to 
which you want the records 
written. 



Keys Specifies how the sort keys are 

embedded within each record. 
Refer to the BTOS Sort/Merge 
Operations Reference Manual for 
more information. 



Optional fields: 

[Stable sort?] Enter y if you want the input 

records that have equal sort keys 
to appear in the output file in the 
same order as they appear in the 
input file. 

The default is no. 



(Work File 1] SORT requires two work files, 

each the same size as the input 
file. Enter the name of an existing 
file; or, if you specify a file that 
does not exist, SORT creates it 
and deletes it at the end of the 
operation. 
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[Work File 2] 

[Log file] 

[Suppress 
confirmation?] 



If you do not specify a work file, 

the system work file 

(Sort Work filel.Dat) is placed on 

the logged-in volume and 

directory. 

SORT requires two work files, 
each the same size as the input 
file. Enter the name of an existing 
file; or, if you specify a file that 
does not exist, SORT creates it 
and deletes it at the end of the 
operation. 

If you do not specify a work file, 
the system work file 
(SortWorkfile2.Dat) is placed on 
the logged-in volume and 
directory. 

Enter the filename to which you 
want the status report and the 
sort statistics written. 



If you enter y, SORT skips any 
corrupt records and searches for 
the next valid record. 
If you enter n, SORT skips any 
corrupt records and displays a 
message inquiring if you want to 
continue or terminate the SORT 
operation. 
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SUBMIT Command 



Figure 51 SUBMIT Command Form 



1 Fila list 1 f 
{PBinDtors] 
[ForoB E)f»ralcn?] 


•"■^ : 1 


Mandatory field: 




File list 


Enter the name of the file you 
want the system to read and 
execute. 


Optional fields: 




[Parameters] 


Specifies parameters (up to 10) 
that replace escape sequences in 
the form %n in the file specified 
in the File list field. The first 
parameter replaces all instances 
of %0; the second, %1; and so on 
through %9. 


(Force Expansion?] 


The default is no. 

Enter y to have the system force 
the expansion of submit escape 
sequences in a file (even though 
you are not passing parameters). 


[Show Expansion?] 


The default is no. 

Enter y to direct the system to 



display the file expansion. This is 
useful for debugging complicated 
conditional expansions. 
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TYPE Command 

Figure 52 TYPE Command Form 



Type 

[Oonflra each?] 



Mandatory field: 

File list Enter the name of the file you 

want to display. You can use a 
wildcard character in this field. 



Optional field: 

[Confirm each?] The default is no; the system does 

not prompt you for confirmation 
before displaying each fiel you 
request. 

To receive prompts to confirm 
each file, enter y. 
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USER FILE EDITOR Command 

Figure 53 USER FILE EDITOR Command Form 



User File Editor 



User name 



[Old password] 
[New password] 
[User template file] 
[Command file] 



Mandatory field: 
User name 



To create a new User file, enter a 
new user name. You cannot enter 
a wild card character. 

To modify an existing User file, 
enter the user name 
corresponding to that field. 



Optional fields: 
[Old Password] 



[New Password] 



[UserTemplate file] 



The default is the currently 
logged-in password. The system 
denies access to a protected file if 
you attempt to open it without a 
valid password. 

To access an existing User file 
with password protection, enter 
that password in this field. 

The default is no password. 

To assign password protection to 
this User file, enter a volume or 
file password in this field. 

The default User File Template is 
[Sys]<Sys>UserFileTemplate.sys 
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[Command file] 



To specify a User File Template 
other than the default, enter the 
Template file name in this field. 

The default command file is 
ISys]<Sys>Sys.cmds. 

To specify a command file other 
than the default for this User file, 
enter the command file name in 
this field. 
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VIDEO Command 

Figure 54 VIDEO Command Form 



[Suppress pause 
between pages?] 



(Screen timeout 
(in minutes)] 

[Color (default - green)] 

[132 columns 
(B 22, B 27 only?)] 



Optional fields: 

[Suppress pause 
between pages?] 



[Screen timeout 
(in minutes)] 



[Color (default 
green)] 



The default is no; the system 
prompts you to press NEXT 
PAGE before scrolling any 
information off the screen. 

To suppress a pause between 
pages displayed on the screen, 
enter y. 

The default does not use the 
screen timeout feature; the screen 
remains on as long as the 
workstation is on. 

To use the screen timeout feature, 
enter the number of minutes delay 
after an entry before the screen 
turns off. 

This field applies to color 
workstations only. 

The default sets green as the color 
for the display. 
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[132 Columns (B 22, 
B 27 only)?] 



To specify a default color other 
than green, enter the name of the 
color. 

This field applies only to B 22 
and B 27 workstations, which 
have wide screen capabilities. 

The default is no; the system sets 
the screen width at 80 columns. 

To set the screen width at 132 
columns, enter y. 
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VOLUME STATUS Command 

Figure 55 VOLUME STATUS Command Form 



voUM Status 



tVoluwi (g oevlce nane] | f: 

[Details?] 

[Print file] 

[Directory spec (default ■ '•*)] 
[Include teifiorary directories?] 



Optional fields: 

[Volume or device 
name] 



[Details?] 



[Print file] 



[Directory spec 
(default = '*')] 



The default is the volume of the 
current path. 

To display the status of a volume 
other than that of the current 
path, enter the volume name. 

The default is no; the system 
displays the status information 
with no details. To display 
detailed status information for 
the volume, enter y. 

If you accept the default, the 
system does not store or print the 
information the command 
generates. The information 
appears on the screen only. 

To store the information in a file 
from which you can later display 
or print it, enter a file name for 
the storage file. 

To send the information directly 
to a device such as a printer, 
enter an appropriate device name. 

The default directs the system to 
display volume status information 
for all the directories in the 
volume. 



5026339 



1-94 



Commands 



[Include temporary 
directories?] 



To display status information for 
specific directories only, enter the 
name(s) of each directory 
enclosed in angle brackets. 

The default is no; the system does 
not include information about 
temporary directories in the 
volume status display. 

To include information about 
temporary directories in the 
volume status display 
information, enter y. 
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WRITE HARDWARE ID Command 

Figure 56 WRITE HARDWARE ID Command Form 



vrite Hardmre ID 

I Integer value (i-i2fe) | 



Mandatory field: 

Integer value (1-126) Enter a number from 1 through 

126 for your workstation that is 
different from the numbers 
assigned to the other 
workstations on the cluster. 
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XESOFTWARE INSTALLATION Command 



Figure 57 XESOmVARE INSTAUATION Commanil Form 



XE Software Installation 




[Cmd file] 






[Files to] 






[Install file] 





Optional fields: 

[Cmd File] The default is the standard 

XE 520 command file, 
[!Sys]<Sys>Sys.cmds. 

To specify a different command 
file, enter the file name or 
complete file specification. 



(Files to] The default is the XE 520 

directory. 

To specify a different directory, 
enter the directory name. 

[Install file] The default installation file is 

[fO]<Sys>Install.sub. 

If the application program uses a 
different installation file, specify 
the file name in this field. 
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Tables 
Introduction 

This section contains a compilation of tables taken from 
the BTOS Standard Software Operations Guide and 
consolidated in one place for easy access. 

This section begins with a list of tables. This list, along 
with the index, should help you easily find the 
information you need. 



Table 


Title 


1 


BTOS Memory and Disk Space Requirements 


2 


System Images for Cluster Workstations with 




Local Hard Disk File Storage 


3 


User File SignOn Entries 


4 


Cluster Communications Lines 


5 


Keyboard Editing Functions 


6 


Device Parameters 


7 


Date/Time Configuration File Codes 


8 


Spooler Configuration File Entries 


9 


Queue Index File Entries 


10 


Executive Printing Commands 


11 


Printer Device Names 


12 


Typical Drive Device Names 


13 


Parameters of Available Hard Disk Drives 


14 


Bad Spot Reports and Sample Entries 


15 


Commonly Used File Suffixes 


16 


File Specifications for Listing Files 


17 


Protection Levels 


18 


Sample SELECTIVE BACKUP File List 




Parameters 


19 


Special Command Edit Functions 


20 


Executive Intrinsic Commands 


21 


Escape Sequence Components 


22 


Hexadecimal Codes for Special Keys 
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Table 1 BIOS IVIemory and Disk Space Bequiremenfs 



Configuration 


Single 

Partition 

(KB) 


Multi- 
Partition 
(KB) 


Disic 

Space 

(Sectors) 


B 21-1 Cluster 


65 






B 21-3 Cluster 
with local 
file storage 

B 21-4 Cluster 

Willi lUwal 

file storage 


95 
100 


— 
125 


— 



B 22 Cluster 


85 


100 


— 


B 22 Cluster 
with local 
file storage 


110 


150 




B 24 


125 


— 




B 26 Standalone 


115 


140 


1400/2900 




1 / 0 




7nn** 

lUU 


R ?fi Clii^tPr 


100 


115 




R ?R riiKtpr 

0 Z.U vlUolCI 

with local 
file storage 


120 


155 




B 27 Standalone 


140 




150 


R 97 Mn«tpr 


220 


230 


1 *tuu/ CUUU 




140 


145 


700** 


R 97 riiictpr 

with local 
file storage 


160 


190 




B 28/38 Standalone 


115 


162 


1400/2900' 


B 28/38 Master 


195 


237 


700** 


B 28/38 Cluster 


100 


137 




B 28/38 Cluster 


120 


177 





with local 
file storage 



* Minimum/Optional requirements (standard software). 

**Cluster operating systems require 1 70 to 300 additional sectors each. 

Note: B 28 and B 38 customized operating systems will be approximately 
22k larger, due to protected mode support. 
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Table 2 System Images for Cluster Workstations with Local Hard Disk 
File Storage 



Workstation Type 


System Image 


B 21-4 Cluster Workstation 


Ws253>Syslmage.Sys 


B 26 Cluster Workstation 


Ws250>Syslmage.Sys 


B 27 Cluster Workstation 


W$125>Syslmag8.Sys 


B 28 Cluster Workstation 


Ws240>Syslmage.Sys 


B 38 Cluster Workstation 


Ws240>Syslmage.Sys 
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Table 3 User File SignOn Entries 



Keyword 



Parameter 



:SignOnVolume: 

:SignOnDirectory: 

:SlgnOnFilePrefix: 

.SignOnPassword: 

:SignOnExitFile: 



iSignOnTextFiie: 



'.SignOnChainFile: 



specifies the volume in the default path 

specifies the directory in the default path 

specifies a file prefix in the default path 

specifies a password required to sign on to the system 

specifies the run file of the environment the 
system loads whenever you exit an application or 
enter ACTION-FINISH 

For example, to return to the Executive when you 
finish a session with an application, enter the 
Executive run file [Sys]<Sys>Exec.run. 

specifies one or more files containing text that the 
system displays when you sign on 

You can specify the default text file 
[Sys]<Sys>System.txt and/or other files 
containing messages you want the system to 
display before activating the initial environment. 

The system also displays any text you enter 
between the end of the last (or only) text file and 
the first colon of the next entry in the User file. 

specifies the run file of the initial environment 

For example, to activate the Executive when you 
sign on, you enter the Executive run file, 
[Sysl<Sys>Exec.run, 



Tables 



2-5 



Table 3 User File SignOn Entries (continued) 

Keyword Parameter 

To bypass the Executive and activate an 
application, programming language, or BTOS 
utility, enter the appropriate run file (for 
applications, programming languages, and utilities, 
refer to the applicable documentation. 

If the Executive command that activates the 
application, programming language, or BTOS utility 
has a command form, you can specify one or more 
parameters; use the following guidelines: 

□ the parameter(s) must appear 
in the line(s) immediately 
following the SignOnChainFile 
entry. 

□ the line(s) containing the 
parameter(s) do not begin with 
a colon. 

□ the first parameter must be 
the command that activates the 
application, programming 
language, or BTOS utility. 

□ the parameter entries can not 
include wild card characters. 

□ if you are using the word 
processing program to edit the 
file, use the SHIFT-RETURN key 
combination to end each line. 

□ two or more blank lines must 
follow the last parameter 
entry. 

□ the next line following the 
blank lines must begin with a 
colon (even if it contains no 
other entry). 

:ExecCmdFile: specifies the Executive command file 

If none is specified, ths system uses the default 
file [Sys]<SYS>Sys.cmds. 
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Table 4 Cluster Communications Lines 



Line Number 


Communications Line 


0 


Standard Channel 


1-4 


Reserved, XE 500 
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Table 5 Keyboard Editing Functions 



Key Function 



ALTIuN-DcLcTc 


clears the Type-Ahead buffer 


ACTION-OVERTYPE 


turns off the screen (press any key to turn it on again) 


BACKSPACE 


□ 


in insert mode (OVERTYPE key 
not activated), deletes the 
last character entered 




□ 


in overtype mode, moves the 
cursor one space to the left 


CANCEL 


□ 


terminates the present command 
form and retaims to a new 
command form without 
completing the execution of 
the original command 




□ 


terminates a multipage display 
initiated by the TYPE and DUMP 
commands 


CODE-DELETE 


de 
is 


ietes the entire entry in a field where the cursor 
located 


CODE-Left Arrow 


moves the cursor to the leftmost column 


CODE-Right Arrow 


moves the cursor to the rightmost column 


DELETE 


de 


Ietes the character at the cursor position 


Down Arrow 


moves the cursor to the next field of a command form 


F1 


□ 


actuates the Redo feature of 
the Executive 

Note: The Redo feature is not 
available for some commands. 




o 


actuates the Retry feature of 
the LCOPY command 



5026339 



2-8 Tables 



Table 5 Keyboard Editing Functions (continued) 
Key Function 

FINISH ends the execution of a command and returns to 

the Executive Command field 

60 Initiates a command when you complete the 

command form 

HELP □ displays a list of ail the 



available Executwe commands 

□ (pressed twice) displays a 
description of each available 
Executive command 

o (pressed after partially 

entering a command name) lists 
and describes the Executive 
commands that match the 
partially entered name 

Q (pressed for a specific 
command) displays a short 
description of the command, 
the name of its run ftle, the 
command case, and the command 
form 

Left Arrow moves the cursor left one column 

NEXT moves the cursor to the next field of a command form 

NEXT PAGE displays the next page when the current command 

requests more than one screen of information 

OVERTYPE places the system into overtype mode and lights 

the indicator on the OVERTYPE key. In this 
mode, the characters you type overwrite existing 
characters at the same positions. 
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Table 5 Keyboard Editing Functions (continued) 


Key 


Function 


RETURN 

llft» I Willi 


movpc tho nircnr tn thp npyt fiplrt nf n rnmmsinrl fnrni 


Right Arrow 


moves the cursor right one column 


SCROLL UP 


rolls text up one line at a time, displaying one 




siHriifinnfil lino of tho hnttntn at tho crroiin* fha 

duuiiiunoi line oi um uuiiuiii ui iiib aucciif iiib 




cursor does not move 


SHIFT-GO 


signals the Executive not to store the command in 




the memory buffer used for the Redo feature 


SHiFT-Left Arrow 


moves the cursor left five columns 


SHIFT-Right Arrow 


moves the cursor right five columns 


TAB 


moves the cursor to the next field of a command form 


Up Arrow 


moves the cursor to the preceding field of a 




command form 
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Table 6 Device Parameters 



Device 


Device Name 




screen 


[VID] 




keyboard 


[KBD] 




printers (nonspooled) 


[PTR]A [PTR]1A 
[PTR]B [PTR]1B 
[LPT] (PTR]1C 
[PTRjlD [PTR]2D 


[PTR]2A 
[PTR]2B 
[PTR]2C 


communications channels 


[CQMMIA 
[COMM]B 




sooolpd Dfinters 


rsPLi rsPLiAi 

(SPLBJ [SPLIB] 
[SPL10] [SPL2D] 


[SPL2A] 
[SPL2B] 


disk drives 


[dO] or [!dO] 
[d1] 

[fO] or [IfO] 
[fl] 




null device 


[NUL] 
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Table 7 Date/Time Configuration File Codes 



Day/Month/Year Sequence: 




Code Format 


Example 


n MM/nn/YY 

U IVllVI/ UU/ 1 1 


UtJf IQ/03 


1 DD/MM/YY 


16/09/85 


2 YY/MM/DD 


85/09/16 


Time Format: 




Code Format 


Example 


D AM/PM format 


2:35 PM 


1 74-hniir fnrmat 


14-35 


Date Format: 




Code Format 


Example 


0 XXX nn, nnnn 


Sep 16, 1985 


1 nn/nn/nn 


09/16/85 


2 XXX nn. 


Sep 16, 


nhnn 


1985 
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Table 8 Spooler Configuration File Entries 



Component 



Explanation 



Channel 



Printer Name 



Queue Name 

Configuration 
File 

Priority 



Banner (Y/N) 



specifies the channel to which the printer is connected 
0 -> Centronics-type (parallel) port 
A - Channel A (serial) 
B > Channel B (serial) 

specifies the name of the printer connected to the 
channel 

The printer name must be the same as the name 
specified in the Device Configuration file 

specifies the name of the Scheduling queue 
assigned to the printer 

specifies the Printer Device Configuration file 

specifies the priority of the Spooler process for 
the printer 

The entry is a number from 10 to 254; 10 is the 
highest priority. The default is 130. 

Accepting the default or entering a higher number 
insures that the printer does not slow down the 
performance of interactive applications (such as 
the word processing program). 

specifies whether the system prints a banner page 
at the beginning of each document 



The default is no. 
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Table 9 Queue Index File Entries 



Component 



Explanation 



Queue Name 
File Specification 



Entry Size 
Queue Type 



specifies the name you assign to the queue 
specifies the queue's file specification 

You enter Scheduling queue file specifications in 
the following format: 

[Sys]<Spl>xxxxx.queue 

where xxxxx is the appropriate queue name. 

You enter Control queue file specifications in the 
following format 

[Sys]<Sys>xx»(xSerialControl.queue 

for serial printers, and 
[Sys]<Sys>xxxxxParalleiControl.queue 
for parallel printers 

where xxxxx is the appropriate printer name. 

You enter the Spooler Status queue specification 
in the following format: 

[Sys]<Sys>SpoolerStatus.qu8U8 

specifies the number of sectors per entry. The 
Spooler requires the entry 1. 

Enter the number 1 to specify a Spooler queue. 
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Table 10 Executive Printing Commands 

Command Type of Printing Action/Explanation 



APPEi\ID 



direct printing 



Refer to APPEND Command. 



COPY 



direct printing or 
spooled printing 



FORMAT 



PRINT 

SPOOLER 
STATUS 



direct printing or 
spooled printing 

spooled printing 
spooled printing 



This command transfers the contents of a 
file to the printer with no formatting such 
as pagination, margins, etc. 

To print a file, enter the name of the file in 
the File from field and the nonspooled 
device name for the printer attached to your 
workstation, in the File to field. 

Refer to COPY Command. 

This command transfers the contents of a 
file to the printer with no formatting such 
as pagination, margins, etc. 

To print a file, enter the name of the file in 
the File from field and the device name for 
the printer attached to your workstation, in 
the File to field. 

This command allows you to 

set the format of a file's contents and then 

print it. Refer to FORMAT Command. 

Refer to PRINT Command. 

This command allows you to monitor and 
control spooled printing as well as print 
files. Refer to SPOOLER STATUS 
Command in the ^705 Standard 
Software Operations Guide. 
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Table 1 1 Printer Device Names 
Spooled 

Nonspooled Device Printer 
Device Name Name Description 



iLptJ 


IbplJ 


Parallel printer interface 


[Ptr]A 




Serial printer (Channel A) 


[Ptr]B 


[SplB] 


Serial printer (Channel B) 


[Ptr]1A 


[SpllAI 


Serial printer (Channel A on four-port 
communications expander) 


[PtrllB 


[SpllB] 


Serial printer (Channel B on four-port 
communications expander) 


[PtrllC 


[SpllC] 


Serial printer (Channel C on four-port 
communications expander) 


rptrim 

11 J 1 u 




OBiicii piiinci \uiiaiiiici u un luui pun 

communications expander) 


[Ptrl2A 


[Spl2Al 


Serial printer (Channel A on four-port 
communications expander) 


[Ptrl2B 


[Spl2Bl 


Serial printer (Channel 6 on four-port 
communications expander) 


[Ptr]2C 


[Spl2C] 


Serial printer (Channel C on four-port 
communications expander) 


[Ptr]2D 


lSpl2D] 


Serial printer (Channel D on four-port 
communications expander) 



Note; [Ptr}A and [Ptr]OA are synonyms. 
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Table 12 Typical Drive Device Names 


Device Name 


Drive Description 


dO 


the first hard disk drh/e at the master workstation or at a 
workstation with local file storage 


d1 


an additional hard disk drive on a workstation 


!dO 


the hard disk drive at the master workstation when specified from 
a cluster workstation with local file storage 


fO 


the first floppy disk drive of a local workstation 


fl 


the second floppy disk drive on a workstation with two floppy 
disk drives 


!fO 


the first floppy disk drive of the master workstation when 
specified from a cluster workstation with local file storage 



Tables 



2-17 



Table 13 


Parameters of Available Hard Disk Drives 




Type 


Size 


Cylinders 


neads 


Sectors 


A 


10Mb 


306 


4 


16 


B 


10Mb 


306 


4 


16 


C 


20Mb 


612 


4 


18 


D 


40Mb 


645 


7 


16 


F 


20Mb 


612 


4 


16 


G 


2GMb 


612 


4 


16 


K 


80Mb 


1024 


8 


16 


M 
IVl 


80Mb 


1024 


8 


1R 

ID 


N 


40Mb 


699 


7 


16 


0 


80Mb ECC 


830 


10 


16 


P 


40Mb ECC 


989 


5 


16 
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Table 14 Bad Spot Reports and Sample Entries 



Report Type 



Sample Bad Spot 
Information 



Sample 
Entries 



Media Defect 
Reports 



Cylinder 
11 
30 



Head 
0 
2 



Sector 
4 
12 



11/0/#4 
30/2/#12 



Note: In your entry, place a number sign before the sector number. 



Media Error 
Maps 



Trk Hd Byte Count 



005 4 
084 1 



00107 
002646 



Length 
(bits) 

03 

04 



5/4/107/3 
84/1/2846/4 



Note: In your entry, eliminate leading zeros in all columns. 



Quantum 

Q2000 

Media 

Defect 

Reports 



Cylinder Head 



84/ 54 1 
241/ F1 2 



Error 
Displace- 
ment 

2646/ A56 
8130/1FC2 



Error 
Length 

4/ 4 
39/27 



84/1/2646/4 
241/2/8130/39 



Note: In your entry, use only the first number set in any column. Do not use 
the numbers following the slash marks. 



Test Summaries 



Hard Cyl 
26 
38 



Map Hd 
3 
2 



Sec 
1 
2 



Byte 

7 

5 



26/3/#l 
38/2/#2 



Note: In your entry, use numbers from columns 1 through 3 only; place a 
number sign before the sector number. 



Media Defect 
Report 



Cylinder 



Byte From 
Index (BFI) 



Length 
(Bits) 



139 
294 



1505 
9061 



201 
221 
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Table 15 Commonly Used File Suffixes 



File Suffix File Description 

.run Run file 

.sub Submit file 

.sys System file 

.1st List file 

.txt Text file 

.user User signon file 

.config Text Configuration file 

.cnfg Code Configuration file 

.tmp Temporary file 

.jci Job Control Language 

.form Form file 

.fmt Format file 

.lib Library file 

.map Linker Map file 

.obj Object file 

-old Old file (The system adds this suffix to the 

original ^|e name when you save a file.) 

>save Saved file (similar to an -old file) 

^new New file (The system adds this suffix to a file 

name durii^ a recovery procedure.) 
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Table 1 6 File Specifications for Listing Files 


File Specification 


Action 


[VolName]<*> 


The system lists all the files in all the directories 




of the specified volume. 


^! VUllliulllCJ <^ ^ 


1 lie oyotciii Hold all uic iiicd in oil iiic uiicuiuiies 




on the master workstation's mass storage unit 




when specified on a cluster workstation with local 




file storage. 


• 


The system lists all the files in the current directory. 


<DirName>* 


The system lists all the files in the specified directory. 


<*>FileName 


The system lists all the files with the specified 




file name in all directories. 


*>FileName 


The system lists all the files with the specified 




file name in all directories and subdirectories. 


SubDirName>* 


The system lists all files in the specified 




subdirectory. 
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Table 17 Protection Levels 


Protection 


Decimal 


Password Required 


Level 


Value 


To Read 


To Modify 


unprotected 


15 


none 


none 


modify passvvord 


7 


none 


volume, 








directory, or 








file 


access password 


3 


volume, 


volume, 






directory, 


directory, or 






or file 


file 


nondirectory password 


51 


volume or file 


volume or file 


nondirectory modify 


23 


none 


volume or file 


password 








nondirectoiy access 


19 


volume, 


volume or file 


password 




directory or file 




modify protected 


5 


none 


volume or 








directory 


access protected 


0 


volume or 


volume or 






directory 


directory 


read passwiHii 


1 


volume, directory 


volume or file 






or file 
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Table 18 Sample SELECTIVE BACKUP File List Parameters 
File List Field 

Parameter Description of Files Archived 



[ABC]<*>* The system copies all files on volume ABC to an 

archive file. This is similar to the BACKUP 
VOLUME operation with no verification. 

[Win]<Work2>* The system copies all files in the directory Work2 

to an archive file. 

@MyFile The system copies a list of files to an archive file. 

You use the Editor or FILES command to create 
an at-file containing the list of files you want to 
copy. For example, here the at-file MyFile contains 
the list of files. 
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Table 19 Special Command Edit Functions 



Function Key Procedure 



INSERT 


F4 


To insert a line in the command form: 






1 Position the highlight below the 






insert location. 






2 Press INSERT (F4). 






3 Type the line. 


DELETE 


F5 


To delete a line in the cotnmand form: 






1 Position the highlight on the line. 






2 Press DELETE (FS). 


BLANK 


F6 


To insert a blank line: 






Caution: Do not press BLANK (F6) when the 






highlight is over a line you want to retain. If you do, 






thp ^vctpm rpniarpc thp pyi<:tinn linp uuith a hlflnk linp 






1 Position the highlight below the 






insert location. 






2 Press INSERT (F4). 






3 Press BLANK (F6). The message 






<blank> appears. 
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Table 20 Executive Intrinsic Commands 



Command Name Run File Field Parameter 



APPEND 


11 


COPY 


!2 


CREATE DIRECTORY 


!14 


CREATE FILE 


!5 


DELETE 


13 


LIST 


18 


LOGIN 


17 


PATH 


!7 


PLAYBACK 


121 


RECORD 


!19 


REMOVE DIRECTORY 


115 


RENAME 


!4 


RUN 


118 


RUN FILE 


116 


SCREEN SETUP 


!17 


SET FILE PREFIX 


!9 


SET PROTECTION 


no 


STOP RECORD 


120 


TYPE 


!6 


VIDEO 


111 
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Table 21 Escape Sequence Components 



Component Function 



% introduces an escape sequence (You can include it in the text by 

typing it twice, %%, in which case, the system ignores it.) 

D expands the current date/time 

[ expands the current volume selection 

< expands the current directory specification 

expands the current password specification 
U expands the current user name specification 

introduces a comment 

introduces a comment 
? introduces a type of conditional expansion 



# introduces a type of conditional expansion 

n represents one of the digits 0 through 9 used to indicate which 

of the parameters in the [Parameters] field in the SUBMIT 
command form replaces the escape sequence 

b is a character that delimits the start and end of conditional 

expansions 

text is a sequence of characters inserted in a conditional expansion, 

including other calls to SUBMIT, other command invocations, 
messages to be output to the screen, etc. 

>n is one of the digits 0 through 9 preceded by another character, 

such as ] 
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Table 21 Escape Sequence Components (continued) 
Component Function 

date/time is the template for introducing date/time; the date and time can 

be formatted by using any of the following parameters: 



Kay 


Expansion 


h 


hour in 12-hour notation (1-12) 


t 


hour in 24-hour notation (0-23) 


m 


minute (0-59) 


s 


second (0-59) 


a 


AM/PM 


y 


year (1952-2042) 


0 


month number (1-12) 


n 


month name 


d 


day of month (1-31) 


w 


weekday name 


Modifier 


Meaning 


0 


zero-filled 


• 


variable width 
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Table 22 Hexadecimal Codes for Special Keys 


Key 


Hex Code 


Display Character 


HELP 


OQ 

uu 


mill 


MARK 


02 


cnlifi rinht trisnnlo 
dUiiU iiyill Uldliyic 


FINISH 


04 


cnliH ^nii/)fp 

OUIIU dIJUulC 


PREV PAGE 


05 


hflllnuu ^fiiiarp 

MVllUW difUulC 


CANCEL 


07 


bell 


BACKSPACE 


08 


UuLrl\dUal»li 


TAB 


09 


tab 


RETURN 


OA 


npw linR 


Down Arrow 


08 


rin\Mn arrnuu 

uuwif uiiun 


NEXT PAGE 


OC 


fnrmfppri 

lui nil C6U 


BOUND 


OD 


caIiH Ipft tnAnnlo 
diiiiu icii iiioiiyic 


MOVE 


OF 


double daooer 


SCROLL UP 


11 


rianner 


SCROLL DOWN 


13 


trough 


COPY 


14 


raised dot 


F1 


15 


Hivieinn cinn 

UlVldlUII OIUII 


F2 


16 


vertical bar 


F3 


17 


dollar sign 


F4 


18 


not eQual 


F5 


19 


similarly 


F6 


1A 


paragraph 


GO 


IB 


solid bullet 


F7 


10 


not 


F8 


ID 


equal to or less than 


F9 


IE 


plus or minus 


FID 


IF 


equal to or greater than 
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MERGE, 1-52 
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PLOG, 1-59 

PRINT. 1-61 

RECORD. 1-64 

REMOVE COMMAND, 1-65 

REMOVE DIRECTORY, 1-66 

RENAME, 1-67 

REPUY, 1-69 

RESTORE. 1-70 

RUN. 1-73 

RUN FILE, 1-74 

SCREEN SETUP, 1-75 

SELECTIVE BACKUP, 1-77 

SET DIRECTORY PROTECTION, 1-80 

SET FILE PREFIX, 1-81 

SET PROTECTION, 1-82 

SET TIME, 1-83 

SOFTWARE INSTALLATION, 1-84 

SORT, 1-85 

SUBMIT, 1-87 

TYPE 1-88 

USER FILE EDITOR. 1-89 

VIDEO, 1-91 

VOLUME STATUS, 1-93 

WRITE HARDWARE ID, 1-95 

XESOFTWARE INSTALUTiON, 1-96 
Commands 

executive instrinsic, 2-24 

executive printing, 2-14 
Commonly used file suffixes, 2-19 
Communications lines 

cluster, 2-6 
Components 

escape sequence, 2-25 
COPY command form, 1-14 
CREATE CONFIGURATION FILE command form, 1-1 5 
CREATE DIRECTORY command form, 1-16 
CREATE FILE command form, 1-18 
CREATE PARTITION command form, 1-20 



Date/time configuration file codes, 2-1 1 
DEBUG FILE command form, 1-21 
DELETE command form, 1-22 
Device names 

printer, 2-15 
Device parameters, 2-10 
DISABLE CLUSTER command form, 1-23 
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Disk space and memory requirements (BTOS), 2-2 
Drive device names, typical, 2-1 6 
DUMP command form, 1-24 

E 

EDIT command form, 1-26 
Editing functions 
keyboard, 2-7 
Entries 

queue index file, 2-13 

spooler configuration file, 2-12 

user file signon, 2-4 
Escape sequence components, 2-25 
Executive 

intrinsic commands, 2-24 

printing commands, 2-14 

F 

FILES command form, 1-17 

File specifications for listing fdes, 2-20 

File suffixes 

commonly used, 2-19 
FLOPPY COPY command form, 1-28 
FORMAT command form, 1-30 
Functions 

keyboard editing, 2-7 

special command edit, 2-23 

H 

Hard disk drives 

parameters of available, 2-17 
Hexadecimal codes for special keys, 2-27 

I 

INSTALL PROTECTED MODE command form. 1-34 
INSTALL SPOOLER command form, 1-35 
INSTALL TELEPHONE SERVER command form, 1-36 
Intrinsic commands 
executive, 2-24 
IVOLUME command form, 1-37 

K 

Keyboard editing functions, 2-7 
Keys 

hexadecimal codes for special, 2-27 
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L 

LCOPY command form, 1<43 
Lovels of protection, 2-21 
LIST command form, 1-46 
Listing files 

file specifications for, 2-20 
LOGIN command form, 1-47 

M 

IMAINTAIN FILE command form, 1-49 
MAKE TRAIVSLATION FILE command form, 1-51 
Memory and disk space requirements (BTOS), 2-2 
MERGE command form, 1-52 

N 

NEW COMMAND command form, 1-54 
P 

Parameters (device), 2-10 
Parameters of available hard disk drives, 2-17 
PATH command form, 1-56 
PLAYBACK command form, 1-58 
PLOG command form, 1-59 
PRINT command form, 1-61 
Printer device names, 2-15 
Printing commands 
executive. 2-14 
Protection levels, 2-21 

Q 

Queue index file entries, 2-13 
R 

RECORD command form, 1-64 
REMOVE COMMAND command form, 1-65 
REMOVE DIRECTORY command form, 1-66 
RENAME command form, 1-67 
REPLAY command form, 1-69 
Requirements 

BTOS memory and disk space, 2-2 
RESTORE command form, 1-70 
RUN command form, 1-73 
RUN FILE command form, 1-74 



Sample SELECTIVE BACKUP file list parameters, 2>22 

SCREEN SETUP command form, 1-75 

SELECTIVE BACKUP command form, 1-77 

SET DIRECTORY PROTECTION command form, 1-80 

SET FILE PREFIX command form, 1-81 

SET PROTECTION command form, 1-82 

SET TIME command form, 1-83 

SignOn entries 

user file, 2-4 
SOFTWARE INSTALLATION command form, 1-84 
SORT command form, 1-85 
Special keys 

hexadecimal codes for, 2-24 
Spooler configuration file entries, 2-12 
SUBMIT command form, 1-87 
SiifTixes (file) 

commonly used, 2-19 

T 

TYPE command form, 1-88 
U 

USER FILE EDITOR command form, 1-89 
User fde signon entries, 2-4 

V 

VIDEO command form, 1-91 

VOLUME STATUS command form, 1-93 

W 

WRITE HARDWARE ID command form, 1-95 
X 

XESOFTWARE INSTALLATION command form, 1-96 
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